# Frontmatter

你可以在 Markdown 文件的顶部添加 front matter，它是一个特殊部分，使用 [YAML](https://yaml.org/) 格式来定义元数据，被包含在文件顶部的三个连字符 `---` 之间。

例如使用 [title](/api/config/config-frontmatter#title) 来指定页面的标题：

```yaml
---
title: Hello world
---
```

你还可以在正文中访问 front matter 中定义的属性，例如：

```mdx
---
title: Hello world
---

# {frontmatter.title}
```

前面定义的属性将作为 `frontmatter` 属性传递给组件。所以最终输出将是：

```html
<h1>Hello world</h1>
```

:::tip
查看 [Front matter 配置](/api/config/config-frontmatter) 了解可用的 front matter 配置。
:::
